Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Utility Functions for Video Channel Callback Functions

SGGrabFrameComplete

The SGGrabFrameComplete function provides the default behavior for your grab-complete function.

pascal ComponentResult SGGrabFrameComplete (SGChannel c, 
                                             short bufferNum,
                                             Boolean *done);

c

Specifies the reference that identifies the channel for this operation. The sequence grabber provides this value to your grab-complete function.

bufferNum

Identifies the buffer. The sequence grabber provides this value to your grab-complete function.

done

Contains a pointer to a Boolean value. The SGGrabFrameComplete function sets this Boolean value to indicate whether the frame has been completely captured. The function sets the Boolean value to true if the capture is complete, and sets it to false if the capture is incomplete. The sequence grabber provides this pointer to your grab-complete function.

SPECIAL CONSIDERATIONS

You should call the SGGrabFrameComplete function only from your grab-complete function. If you call it at any other time, results are unpredictable.

RESULT CODE

cantDoThatInCurrentMode

-9402

Request invalid in current mode

SEE ALSO

See "Application-Defined Functions," which begins on page 5-107, for details about grab-complete functions.

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help